Carbon


CountComponents

Header: Components.h Carbon status: Supported

Returns the number of registered components that meet the selection criteria specified by your application.

SInt32 CountComponents (
    ComponentDescription *looking
);
Parameter descriptions
looking

A pointer to a ComponentDescription structure. Your application specifies the criteria for the component search in the fields of this structure.

The Component Manager ignores fields in the component description structure that are set to 0. For example, if you set all the fields to 0, the Component Manager returns the number of components registered in the system. Similarly, if you set all fields to 0 except for the componentManufacturer field, the Component Manager returns the number of registered components supplied by the manufacturer you specify.

function result

The number of components that meet the specified search criteria.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)